Предыдущая | Следущая

MovieClipLoader.onLoadError

Доступность

Flash Player 7.

Синтаксис

listenerObject.onLoadError = function(target_mc:Object, errorCode:String) {
  // код
}

Параметры

listenerObject Объект-слушатель событий (listener), добавленный при помощи MovieClipLoader.addListener().

target_mc Клип, загруженный методом MovieClipLoader.loadClip(). Необязательный параметр.

errorCode Строка, объясняющая причину ошибки.

Возвращает

Одну из строк: "URLNotFound"(адрес не найден) или "LoadNeverCompleted"(ЗагрузкаНеЗавершится).

Описание

Listener; вызывается при неудачной загрузке файла с помощью MovieClipLoader.loadClip() .

Строка "URLNotFound" возвращается если ни один из обработчиков MovieClipLoader.onLoadStart или MovieClipLoader.onLoadComplete не был вызван. Например, если сервер не работает или файл вообще не был найден, то эти обработчики не вызываются.

Строка "LoadNeverCompleted" возвращается если MovieClipLoader.onLoadStart был вызван, а MovieClipLoader.onLoadComplete - нет. Например, если MovieClipLoader.onLoadStart был вызван, но загрузка была прервана, например, из-за перегрузки или падения сервера, то MovieClipLoader.onLoadComplete не будет вызван.

Значение target_mc указывает на клип, для кторого был применен вызов метода. Этим параметром удобно пользоваться при загрузке нескольких файлов с одним и тем же набором listener'ов. Этот необязательный параметр передается в код функции.

Пример

Пример выводит информацию в окно при неудачной загрузке изображения. Это произойдет если Вы протестируете приведенный код, поскольку указанный для загрузки файл не существует.

this.createEmptyMovieClip("image_mc", this.getСледущаяHighestDepth());
var mclListener:Object = new Object();
mclListener.onLoadError = function(target_mc:MovieClip, errorCode:String) {
  trace("ERROR!");
  switch (errorCode) {
  case 'URLNotFound' :
    trace("\t Unable to connect to URL: "+target_mc._url);
    break;
  case 'LoadNeverCompleted' :
    trace("\t Unable to complete download: "+target_mc);
    break;
  }
};
mclListener.onLoadInit = function(target_mc:MovieClip) {
  trace("success");
  trace(image_mcl.getProgress(target_mc).bytesTotal+" bytes loaded");
};
var image_mcl:MovieClipLoader = new MovieClipLoader();
image_mcl.addListener(mclListener);
image_mcl.loadClip("http://www.fakedomain.com/images/bad_hair_day.jpg", image_mc);

Посмотреть комментарии LiveDocs		Предыдущая | Следущая